home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / doc / dnsmasq-base / README.Debian < prev    next >
Encoding:
Text File  |  2009-08-31  |  3.0 KB  |  60 lines
  1. Notes on configuring dnsmasq as packaged for Debian.
  2.  
  3. (1) To configure dnsmasq edit /etc/dnsmasq.conf. The file is well
  4.     commented; see also the dnsmasq.8 man page for explanation of
  5.     the options. The file /etc/default/dnsmasq also exists but it
  6.     shouldn't need to be touched in most cases. To set up DHCP
  7.     options you might need to refer to a copy of RFC 2132. This is 
  8.     available on Debian systems in the package doc-rfc-std as the file
  9.     /usr/share/doc/RFC/draft-standard/rfc2132.txt.gz .
  10.  
  11. (2) Installing the dnsmasq package also creates the directory
  12.     /etc/dnsmasq.d which is searched by dnsmasq for configuration file
  13.     fragments. This behaviour can be disabled by editing 
  14.     /etc/default/dnsmasq.
  15.  
  16. (3) If the Debian resolvconf package is installed then, regardless
  17.     of what interface configuration daemons are employed, the list of
  18.     nameservers to which dnsmasq should forward queries can be found
  19.     in /var/run/dnsmasq/resolv.conf; also, 127.0.0.1 is listed as the
  20.     first nameserver address in /etc/resolv.conf. This works using the
  21.     default configurations of resolvconf and dnsmasq.
  22.  
  23. (4) In the absence of resolvconf, if you are using dhcpcd then
  24.     dnsmasq should read the list of nameservers from the automatically
  25.     generated file /etc/dhcpc/resolv.conf.  You should list 127.0.0.1
  26.     as the first nameserver address in /etc/resolv.conf.
  27.  
  28. (5) In the absence of resolvconf, if you are using pppd then
  29.     dnsmasq should read the list of nameservers from the automatically
  30.     generated file /etc/ppp/resolv.conf.  You should list 127.0.0.1
  31.     as the first nameserver address in /etc/resolv.conf.
  32.  
  33. (6) If you run multiple DNS servers on a single machine, each
  34.     listening on a different interface, then it is necessary to use 
  35.     the bind-interfaces option by uncommenting "bind-interfaces" in 
  36.     /etc/dnsmasq.conf. This option stops dnsmasq from binding the 
  37.     wildcard address and allows servers listening on port 53 on
  38.     interfaces not in use by dnsmasq to work. The Debian 
  39.     libvirt package will add a configuration file in /etc/dnsmasq.d
  40.     which does this so that the "system" dnsmasq and "private" dnsmasq
  41.     instances started by libvirt do not clash.
  42.  
  43. (7) The following options are supported in DEB_BUILD_OPTIONS
  44.       noopt   : compile without optimisation.
  45.       nostrip : don't remove symbols from binary. 
  46.       nodocs  : omit documentation.
  47.       notftp  : omit TFTP support.
  48.       noipv6  : omit IPv6 support.
  49.       nodbus  : omit DBus support.
  50.       nortc   : compile alternate mode suitable for systems without an RTC.
  51.       noi18n  : omit translations and internationalistaion support.
  52.  
  53. (8) Dnsmasq comes as two packages - dnsmasq-base and
  54.     dnsmasq. dnsmasq-base provides the dnsmasq executable and
  55.     documentation (including this file). Dnsmasq, which depends on
  56.     dnsmasq-base, provides the init script and configuration
  57.     infrastructure. This file assumes that both are installed. It is
  58.     possible to install only dnsmasq-base and use dnsmasq as a
  59.     non-"system" daemon. Libvirt, for instance, does this.
  60.